home *** CD-ROM | disk | FTP | other *** search
/ SGI Networker 4.2.9 / Networker 4.2.9 for IRIX 6.2, 6.3 and 6.4.img / dist / networker4.idb / usr / share / catman / a_man / cat1m / save.z / save
Text File  |  1997-07-08  |  13KB  |  265 lines
  1.  
  2.  
  3.  
  4. SSSSAAAAVVVVEEEE((((1111MMMM))))                                                              SSSSAAAAVVVVEEEE((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      save - save files to long term storage with NetWorker
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ssssaaaavvvveeee [ ----BBBBEEEEiiiiLLLLnnnnqqqqvvvvxxxx ] [ ----ssss _s_e_r_v_e_r ] [ ----cccc _c_l_i_e_n_t-_n_a_m_e ] [ ----NNNN _n_a_m_e ] [ ----eeee
  13.      _e_x_p_i_r_a_t_i_o_n ] [ ----ffff _d_i_r_f_i_l_e ] [ ----bbbb _p_o_o_l ] [ ----FFFF _f_i_l_e ] [ ----IIII _i_n_p_u_t__f_i_l_e ] [
  14.      ----gggg _g_r_o_u_p ] [ ----llll _l_e_v_e_l ] [ ----tttt _d_a_t_e ] [ ----mmmm _m_a_s_q_u_e_r_a_d_e ] [ ----WWWW _w_i_d_t_h ] [ _p_a_t_h
  15.      ... ]
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      ssssaaaavvvveeee saves files, including directories or entire filesystems, to the
  19.      NetWorker server (see nnnnssssrrrr(1M)).  The progress of a save can be monitored
  20.      using the X Window System based nnnnwwwwaaaaddddmmmmiiiinnnn(1M) program or the ccccuuuurrrrsssseeeessss(3X)
  21.      based nnnnssssrrrrwwwwaaaattttcccchhhh(1M) program for other terminal types.
  22.  
  23.      If no _p_a_t_h arguments are specified on the command line or via the ----IIII
  24.      option, the current directory will be saved.  ssssaaaavvvveeee will save a directory
  25.      by saving all the files and subdirectories it contains, but it will not
  26.      cross mount points, nor will it follow symbolic links.  If the paths to
  27.      be saved are mounted from a network file server, ssssaaaavvvveeee will instruct the
  28.      user to run the save on the remote machine or use the ----LLLL option.
  29.  
  30.      The directive files (see nnnnssssrrrr(4)) encountered in each directory will be
  31.      read by default, and they contain special instructions directing how
  32.      particular files are to be saved (i.e. compressed, skipped, etc.).  These
  33.      files are named '....nnnnssssrrrr'.
  34.  
  35.      Each file in the subdirectory structures specified by the _p_a_t_h arguments
  36.      will be encapsulated in a NetWorker save stream.  This stream of data is
  37.      sent to a receiving process (see nnnnssssrrrrdddd(1M)) on the NetWorker server, which
  38.      will process the data, adding entries to the on-line index (see
  39.      nnnnssssrrrriiiinnnnddddeeeexxxxdddd(1M)) for each file in the stream, with the data finally ending
  40.      up on some long term storage media (see nnnnssssrrrrmmmmmmmmdddd(1M)).
  41.  
  42.      Details about handling media are discussed in nnnnssssrrrrmmmmmmmm(1M) and
  43.      nnnnssssrrrr____ddddeeeevvvviiiicccceeee(4).
  44.  
  45. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  46.      ----EEEE   Estimate the amount of data which will be generated by the save,
  47.           then perform the actual save.  Note that the estimate is generated
  48.           from the inode information, and thus the data is only actually read
  49.           once.
  50.  
  51.      ----IIII _i_n_p_u_t__f_i_l_e
  52.           In addtion to taking the paths to save from the command line, read
  53.           paths to save from the named file.  The paths must be listed one per
  54.           line.  If no paths are specified on the command line, then only
  55.           those paths specified in the file will be saved.
  56.  
  57.      ----iiii   Ignore any .nsr directive files as they are encountered in the
  58.           subdirectory structures being saved.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSAAAAVVVVEEEE((((1111MMMM))))                                                              SSSSAAAAVVVVEEEE((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      ----LLLL   Local.  Saves will be performed from the local NetWorker client,
  75.           even when files are from a network file server.  To recover these
  76.           files, run rrrreeeeccccoooovvvveeeerrrr(1M) with the ----cccc _c_l_i_e_n_t arguments, where _c_l_i_e_n_t is
  77.           the name of the NetWorker client that did the ssssaaaavvvveeee.
  78.  
  79.      ----LLLLLLLL  In additional to treating the backup as a local backup, cause an
  80.           extra line to be printed at the end of the completion output of the
  81.           form ``complete savetime=number'', where number is the savetime of
  82.           the save set created by this backup.  This option is meant to be
  83.           used by the ssssaaaavvvveeeeggggrrrrpppp(1M) command in performing automatic cloning.
  84.  
  85.      ----mmmm _m_a_s_q_u_e_r_a_d_e
  86.           Specifies the tag to precede the summary line with.  This option is
  87.           used by ssssaaaavvvveeeeggggrrrrpppp(1M) and ssssaaaavvvveeeeffffssss(1M) to aid in savegrp summary
  88.           notifications.
  89.  
  90.      ----nnnn   No save.  Estimate the amount of data which will be generated by the
  91.           save, but do not perform the actual save.
  92.  
  93.      ----vvvv   Verbose.  Cause the ssssaaaavvvveeee program to tell you in great detail what it
  94.           is doing as it proceeds.
  95.  
  96.      ----qqqq   Quiet. Display only summary information and error messages.
  97.  
  98.      ----ssss _s_e_r_v_e_r
  99.           Specify which machine to use as the NetWorker server.  The default
  100.           is the current machine if it is running a server, otherwise the
  101.           machine with the logical name ``nsrhost'' in the host table (see
  102.           hhhhoooossssttttssss(4)) is used.
  103.  
  104.      ----cccc _c_l_i_e_n_t-_n_a_m_e
  105.           Specify the client name for starting the save session.  This is
  106.           useful on clients with multiple network interfaces, and hence
  107.           multiple host names.  It can be used to create multiple index
  108.           databases for the same physical client.  Note that this does not
  109.           specify the network interface to use.  This is specified in the
  110.           sssseeeerrrrvvvveeeerrrr nnnneeeettttwwwwoooorrrrkkkk iiiinnnntttteeeerrrrffffaaaacccceeee attribute of the client resource (see
  111.           nnnnssssrrrr____cccclllliiiieeeennnntttt(4)).
  112.  
  113.      ----NNNN _n_a_m_e
  114.           The symbolic name of this save set.  By default, the most common
  115.           prefix of the _p_a_t_h arguments is used as the save set name.
  116.  
  117.      ----eeee _e_x_p_i_r_a_t_i_o_n
  118.           Sets the date (in nnnnssssrrrr____ggggeeeettttddddaaaatttteeee(3) format) when this save set will
  119.           expire.  By default, no explicit save set expiration date is used.
  120.  
  121.      ----ffff _d_i_r_f_i_l_e
  122.           The file from which to read prototype default directives (see
  123.           nnnnssssrrrr(4)).  A _d_i_r_f_i_l_e of ---- causes the default directives to be read
  124.           from standard input.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SSSSAAAAVVVVEEEE((((1111MMMM))))                                                              SSSSAAAAVVVVEEEE((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      ----bbbb _p_o_o_l
  141.           Specifies a particular destination pool for the save.
  142.  
  143.      ----FFFF _f_i_l_e
  144.           Only save files whose change time is newer than the file
  145.           modification date of _f_i_l_e.
  146.  
  147.      ----gggg _g_r_o_u_p
  148.           This option is used by ssssaaaavvvveeeeggggrrrrpppp(1M) and ssssaaaavvvveeeeffffssss(1M) to denote the
  149.           group of the save (see nnnnssssrrrr____cccclllliiiieeeennnntttt(4) and nnnnssssrrrr____ggggrrrroooouuuupppp(4)) and is used
  150.           by the NetWorker server to select the specific media pool.
  151.  
  152.      ----llll _l_e_v_e_l
  153.           The level of the save.  This option is used by ssssaaaavvvveeeeggggrrrrpppp(1M) and
  154.           ssssaaaavvvveeeeffffssss(1M) to specify a particular level for a scheduled save.
  155.  
  156.      ----tttt _d_a_t_e
  157.           The date (in nnnnssssrrrr____ggggeeeettttddddaaaatttteeee(3) format) after which files must have been
  158.           modified before they will be saved.  This option is used by
  159.           ssssaaaavvvveeeeggggrrrrpppp(1M) and ssssaaaavvvveeeeffffssss(1M) to perform scheduled saves by consulting
  160.           with the media database to determine the appropriate time value
  161.           based on the previous saves for the save set and the level of the
  162.           scheduled save.
  163.  
  164.      ----WWWW _w_i_d_t_h
  165.           The width used when formatting summary information output.
  166.  
  167.      ----xxxx   Cross mount points.
  168.  
  169.      ----BBBB   Force save of all connecting directory information from root (``/'')
  170.           down to the point of invocation.
  171.  
  172. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  173.      ccccuuuurrrrsssseeeessss(3X), nnnnssssrrrr____ggggeeeettttddddaaaatttteeee(3), hhhhoooossssttttssss(4), nnnnwwwwaaaaddddmmmmiiiinnnn(1M), nnnnssssrrrr(4), nnnnssssrrrr(1M),
  174.      nnnnssssrrrr____cccclllliiiieeeennnntttt(4), nnnnssssrrrr____ddddeeeevvvviiiicccceeee(4), nnnnssssrrrr____ggggrrrroooouuuupppp(4), nnnnssssrrrr____sssseeeerrrrvvvviiiicccceeee(4), nnnnssssrrrrdddd(1M),
  175.      nnnnssssrrrriiiinnnnddddeeeexxxxdddd(1M), nnnnssssrrrrmmmmmmmm(1M), nnnnssssrrrrmmmmmmmmdddd(1M), nnnnssssrrrrwwwwaaaattttcccchhhh(1M), rrrreeeeccccoooovvvveeeerrrr(1M),
  176.      ssssaaaavvvveeeeffffssss(1M), ssssaaaavvvveeeeggggrrrrpppp(1M)
  177.  
  178. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  179.    EEEExxxxiiiitttt CCCCooooddddeeeessss
  180.      0000    Normal exit.  This means that a save set was correctly created on
  181.           the server.  Messages about individual file backup failures are
  182.           _w_a_r_n_i_n_g_s, and do not cause abnormal exit.
  183.      1111    Abnormal exit.  A save set was not correctly created on the server.
  184.  
  185.    MMMMeeeessssssssaaaaggggeeeessss
  186.      _h_o_s_t:::: _s_a_v_e_s_e_t   lllleeeevvvveeeellll====_l_e_v_e_l,,,,  _s_i_z_e   _t_i_m_e  _c_o_u_n_t ffffiiiilllleeeessss....
  187.           This message (with the appropriate client host name, saveset name,
  188.           level, total save set size, elapsed time, and file count) is printed
  189.           whenever ssssaaaavvvveeee is run by ssssaaaavvvveeeeggggrrrrpppp(1M) and exits normally.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. SSSSAAAAVVVVEEEE((((1111MMMM))))                                                              SSSSAAAAVVVVEEEE((((1111MMMM))))
  203.  
  204.  
  205.  
  206.      _h_o_s_t:::: _f_i_l_e_n_a_m_e:::: _w_a_r_n_i_n_g
  207.           Messages of this form are warnings about difficulties backing up
  208.           individual files.  Such messages do not normally cause the ssssaaaavvvveeee to
  209.           fail, and therefore may appear in the ssssaaaavvvveeee output found in the
  210.           ``Savegroup Completion'' message's Successful section.
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.